函数
相机初始化及销毁

包含枚举相机、创建句柄、打开相机等接口 更多...

函数

MV_CAMCTRL_API int __stdcall MV_CC_EnumerateTls ()
 获取支持的传输层 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_EnumDevices (IN unsigned int nTLayerType, IN OUT MV_CC_DEVICE_INFO_LIST *pstDevList)
 枚举设备 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_EnumDevicesEx (IN unsigned int nTLayerType, IN OUT MV_CC_DEVICE_INFO_LIST *pstDevList, IN const char *strManufacturerName)
 根据厂商名字枚举设备 更多...
 
MV_CAMCTRL_API bool __stdcall MV_CC_IsDeviceAccessible (IN MV_CC_DEVICE_INFO *pstDevInfo, IN unsigned int nAccessMode)
 设备是否可达 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_SetSDKLogPath (IN const char *strSDKLogPath)
 设置SDK日志路径 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_CreateHandle (OUT void **handle, IN const MV_CC_DEVICE_INFO *pstDevInfo)
 创建设备句柄 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_CreateHandleWithoutLog (OUT void **handle, IN const MV_CC_DEVICE_INFO *pstDevInfo)
 创建设备句柄,不生成日志 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_DestroyHandle (IN void *handle)
 销毁设备句柄 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_OpenDevice (IN void *handle, IN unsigned int nAccessMode, IN unsigned short nSwitchoverKey)
 打开设备 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_CloseDevice (IN void *handle)
 关闭设备 更多...
 
MV_CAMCTRL_API int __stdcall MV_CC_GetDeviceInfo (IN void *handle, IN OUT MV_CC_DEVICE_INFO *pstDevInfo)
 获取设备信息,取流之前调用 更多...
 

详细描述

包含枚举相机、创建句柄、打开相机等接口

函数说明

◆ MV_CC_EnumerateTls()

MV_CAMCTRL_API int __stdcall MV_CC_EnumerateTls ( )

获取支持的传输层

返回
支持的传输层编号

◆ MV_CC_EnumDevices()

MV_CAMCTRL_API int __stdcall MV_CC_EnumDevices ( IN unsigned int  nTLayerType,
IN OUT MV_CC_DEVICE_INFO_LIST *  pstDevList 
)

枚举设备

参数
nTLayerType[IN] 枚举传输层
按位表示,支持复选,可选协议类型如下所示:
宏定义 宏定义值 含义
MV_UNKNOW_DEVICE 0x00000000 未知设备类型
MV_GIGE_DEVICE 0x00000001 GigE设备
MV_1394_DEVICE 0x00000002 1394-a/b设备
MV_USB_DEVICE 0x00000004 USB3.0设备
MV_CAMERALINK_DEVICE 0x00000008 CameraLink设备
例如:nTLayerType = MV_GIGE_DEVICE | MV_USB_DEVICE,表示查找GigE和USB3.0设备
pstDevList[OUT] 设备列表
返回
成功,返回MV_OK;失败,返回错误码 。
备注
 • 设备列表的内存是在SDK内部分配的,多线程调用该接口时会进行设备列表内存的释放和申请。
 • 建议尽量避免多线程枚举操作。
示例
ChunkData.cpp, Events.cpp, ForceIP.cpp, Grab_ImageCallback.cpp, GrabImage.cpp, GrabImage_HighPerformance.cpp, GrabMultipleCamera.cpp, ImageProcess.cpp, MultiCast.cpp, ParametrizeCamera_FileAccess.cpp, ParametrizeCamera_LoadAndSave.cpp, ReconnectDemo.cpp, SetIO.cpp, SetParam.cpp, Trigger_Image.cpp , 以及 Trigger_ImageCallback.cpp.

◆ MV_CC_EnumDevicesEx()

MV_CAMCTRL_API int __stdcall MV_CC_EnumDevicesEx ( IN unsigned int  nTLayerType,
IN OUT MV_CC_DEVICE_INFO_LIST *  pstDevList,
IN const char *  strManufacturerName 
)

根据厂商名字枚举设备

参数
nTLayerType[IN] 枚举传输层
按位表示,支持复选,可选协议类型如下所示:
宏定义 宏定义值 含义
MV_UNKNOW_DEVICE 0x00000000 未知设备类型
MV_GIGE_DEVICE 0x00000001 GigE设备
MV_1394_DEVICE 0x00000002 1394-a/b设备
MV_USB_DEVICE 0x00000004 USB3.0设备
MV_CAMERALINK_DEVICE 0x00000008 CameraLink设备
例如:nTLayerType = MV_GIGE_DEVICE | MV_USB_DEVICE ,表示查找GigE和USB3.0设备
pstDevList[OUT] 设备列表
strManufacturerName[IN] 厂商名字
返回
成功,返回MV_OK;失败,返回错误码 。
备注
 • 设备列表的内存是在SDK内部分配的,多线程调用该接口时会进行设备列表内存的释放和申请。
 • 建议尽量避免多线程枚举操作。

◆ MV_CC_IsDeviceAccessible()

MV_CAMCTRL_API bool __stdcall MV_CC_IsDeviceAccessible ( IN MV_CC_DEVICE_INFO *  pstDevInfo,
IN unsigned int  nAccessMode 
)

设备是否可达

参数
pstDevInfo[IN] 设备信息结构体
nAccessMode[IN] 访问权限
宏定义 宏定义值 含义
MV_ACCESS_Exclusive 1 独占权限,其他APP只允许读CCP寄存器
MV_ACCESS_ExclusiveWithSwitch 2 可以从5模式下抢占权限,然后以独占权限打开
MV_ACCESS_Control 3 控制权限,其他APP允许读所有寄存器
MV_ACCESS_ControlWithSwitch 4 可以从5的模式下抢占权限,然后以控制权限打开
MV_ACCESS_ControlSwitchEnable 5 以可被抢占的控制权限打开
MV_ACCESS_ControlSwitchEnableWithKey 6 可以从5的模式下抢占权限,然后以可被抢占的控制权限打开
MV_ACCESS_Monitor 7 读模式打开设备,适用于控制权限下
返回
可达,返回true;不可达,返回false
备注
 • 读取设备CCP寄存器的值,判断当前状态是否具有某种访问权限。
 • 如果设备不支持MV_ACCESS_ExclusiveWithSwitch、MV_ACCESS_ControlWithSwitch、MV_ACCESS_ControlSwitchEnableWithKey这三种模式,接口返回false。目前设备不支持这3种抢占模式,国际上主流的厂商的设备也都暂不支持这3种模式。

◆ MV_CC_SetSDKLogPath()

MV_CAMCTRL_API int __stdcall MV_CC_SetSDKLogPath ( IN const char *  strSDKLogPath)

设置SDK日志路径

参数
strSDKLogPath[IN] SDK日志路径
返回
成功,返回MV_OK;失败,返回错误码 。
备注
 • 设置路径之后,可以指定路径存放日志。
 • v2.4.1版本新增日志服务,开启服务之后该接口无效,默认日志服务为开启状态。

◆ MV_CC_CreateHandle()

MV_CAMCTRL_API int __stdcall MV_CC_CreateHandle ( OUT void **  handle,
IN const MV_CC_DEVICE_INFO *  pstDevInfo 
)

创建设备句柄

参数
handle[OUT] 设备句柄
pstDevInfo[IN] 设备信息结构体
返回
成功,返回MV_OK;失败,返回错误码 。
备注
 • 根据输入的设备信息,创建库内部必须的资源和初始化内部模块。通过该接口创建句柄,调用SDK接口,会默认生成SDK日志文件,如果不需要生成日志文件,可以通过 MV_CC_CreateHandleWithoutLog() 创建句柄。
示例
ChunkData.cpp, ConnectSpecCamera.cpp, Events.cpp, ForceIP.cpp, Grab_ImageCallback.cpp, GrabImage.cpp, GrabImage_HighPerformance.cpp, GrabMultipleCamera.cpp, ImageProcess.cpp, MultiCast.cpp, ParametrizeCamera_FileAccess.cpp, ParametrizeCamera_LoadAndSave.cpp, ReconnectDemo.cpp, SetIO.cpp, SetParam.cpp, Trigger_Image.cpp , 以及 Trigger_ImageCallback.cpp.

◆ MV_CC_CreateHandleWithoutLog()

MV_CAMCTRL_API int __stdcall MV_CC_CreateHandleWithoutLog ( OUT void **  handle,
IN const MV_CC_DEVICE_INFO *  pstDevInfo 
)

创建设备句柄,不生成日志

参数
handle[OUT] 设备句柄
pstDevInfo[IN] 设备信息结构体
返回
成功,返回MV_OK;失败,返回错误码 。
备注
 • 根据输入的设备信息,创建库内部必须的资源和初始化内部模块。通过该接口创建句柄,调用SDK接口,不会默认生成SDK日志文件,如果需要生成日志文件可以通过 MV_CC_CreateHandle() 创建句柄,日志文件自动生成。

◆ MV_CC_DestroyHandle()

MV_CAMCTRL_API int __stdcall MV_CC_DestroyHandle ( IN void *  handle)

◆ MV_CC_OpenDevice()

MV_CAMCTRL_API int __stdcall MV_CC_OpenDevice ( IN void *  handle,
IN unsigned int  nAccessMode,
IN unsigned short  nSwitchoverKey 
)

打开设备

参数
handle[IN] 设备句柄
nAccessMode[IN] 访问权限
宏定义 宏定义值 含义
MV_ACCESS_Exclusive 1 独占权限,其他APP只允许读CCP寄存器
MV_ACCESS_ExclusiveWithSwitch 2 可以从5模式下抢占权限,然后以独占权限打开
MV_ACCESS_Control 3 控制权限,其他APP允许读所有寄存器
MV_ACCESS_ControlWithSwitch 4 可以从5的模式下抢占权限,然后以控制权限打开
MV_ACCESS_ControlSwitchEnable 5 以可被抢占的控制权限打开
MV_ACCESS_ControlSwitchEnableWithKey 6 可以从5的模式下抢占权限,然后以可被抢占的控制权限打开
MV_ACCESS_Monitor 7 读模式打开设备,适用于控制权限下
nSwitchoverKey[IN] 切换访问权限时的密钥
返回
成功,返回MV_OK;失败,返回错误码 。
备注
 • 根据设置的设备参数,找到对应的设备,连接设备。
 • 调用接口时可不传入nAccessMode和nSwitchoverKey,此时默认设备访问模式为独占权限。目前设备暂不支持MV_ACCESS_ExclusiveWithSwitch、MV_ACCESS_ControlWithSwitch、MV_ACCESS_ControlSwitchEnable、MV_ACCESS_ControlSwitchEnableWithKey这四种抢占模式。
 • 对于U3V设备,nAccessMode、nSwitchoverKey这两个参数无效。
示例
ChunkData.cpp, ConnectSpecCamera.cpp, Events.cpp, Grab_ImageCallback.cpp, GrabImage.cpp, GrabImage_HighPerformance.cpp, GrabMultipleCamera.cpp, ImageProcess.cpp, MultiCast.cpp, ParametrizeCamera_FileAccess.cpp, ParametrizeCamera_LoadAndSave.cpp, ReconnectDemo.cpp, SetIO.cpp, SetParam.cpp, Trigger_Image.cpp , 以及 Trigger_ImageCallback.cpp.

◆ MV_CC_CloseDevice()

MV_CAMCTRL_API int __stdcall MV_CC_CloseDevice ( IN void *  handle)

关闭设备

参数
handle[IN] 设备句柄
返回
成功,返回MV_OK;失败,返回错误码
备注
 • 通过 MV_CC_OpenDevice() 连接设备后,可以通过该接口断开设备连接,释放资源
示例
ChunkData.cpp, ConnectSpecCamera.cpp, Events.cpp, Grab_ImageCallback.cpp, GrabImage.cpp, GrabImage_HighPerformance.cpp, GrabMultipleCamera.cpp, MultiCast.cpp, ParametrizeCamera_FileAccess.cpp, ParametrizeCamera_LoadAndSave.cpp, ReconnectDemo.cpp, SetIO.cpp, SetParam.cpp, Trigger_Image.cpp , 以及 Trigger_ImageCallback.cpp.

◆ MV_CC_GetDeviceInfo()

MV_CAMCTRL_API int __stdcall MV_CC_GetDeviceInfo ( IN void *  handle,
IN OUT MV_CC_DEVICE_INFO *  pstDevInfo 
)

获取设备信息,取流之前调用

参数
handle[IN] 设备句柄
pstDevInfo[IN][OUT] 返回给调用者有关设备信息结构体指针
返回
成功,返回MV_OK;失败,返回错误码
备注
 • 支持用户在打开设备后获取设备信息。
 • 若该设备是GigE设备,则调用该接口存在阻塞风险,因此不建议在取流过程中调用该接口。